== Overview ==

* /dev/mmcblk0p1 BOOT
* /dev/mmcblk0p2 ROOTFS
* /dev/mmcblk0p3 RESCUEFS
* /dev/mmcblk0p4 VAR


* paigo主程序: '''/usr/bin/paigo-qt'''
* paigo ap脚本: '''/usr/bin/paigo-ap.sh'''
* paigo wifi脚本: '''/usr/bin/paigo-wifi.sh'''


* 系统固化数据存储路径: 
** 系统图片: /usr/share/images/
** APP图片: /usr/share/paigo/images/
** 系统音频: /usr/share/sounds/
** APP音频: /usr/share/paigo/audios/
** 系统动画: /usr/share/paigo/animations/
** APP动画: /usr/share/paigo/emotions/

* 用户数据存储路径: 
** APP图片: /var/lib/paigo/images/
** APP音频: /var/lib/paigo/audios/
** APP动画: /var/lib/paigo/emotions/

* 配置文件:
** paigo conf: /var/lib/paigo/paigo_conf.ini
** wifi conf: /var/lib/paigo/wifi.conf
** ap conf: /var/lib/paigo/hostapd.conf
** 产品类型配置文件（Paigo / Augie）: /boot/uboot/product_type
** APP版本控制文件：/var/lib/paigo/resources/VersionConfig.xml

* 日志文件:
** info log: /var/log/paigo/info.log
** error log: /var/log/paigo/error.log
** stm32 data: /var/log/paigo/stm32-data-:hh-:mm.log

== 声音文件描述 == 

以下的文件路径中的%1如无特殊说明，均表示资源主题名称。

=== 升级相关 ===

* /usr/share/paigo/audios/app-downloading-firmware-cn.wav 正在下载固件中文提示音
* /usr/share/paigo/audios/app-downloading-firmware-en.wav 正在下载固件中文提示音
* /usr/share/paigo/images/app-downloading-firmware-cn.png 正在下载固件中文图片
* /usr/share/paigo/images/app-downloading-firmware-en.png 正在下载固件英文图片
*
* /usr/share/paigo/audios/app-upgrade-preparing-en.wav 固件下载完成准备升级提示音英文版
* /usr/share/paigo/audios/app-upgrade-preparing-cn.wav 固件下载完成准备升级提示音中文版
* /usr/share/paigo/images/app-upgrade-preparing-en.png 固件下载完成，准备升级英文图片
* /usr/share/paigo/images/app-upgrade-preparing-cn.png 固件下载完成，准备升级中文图片
*
* /usr/share/paigo/audios/app-failed-download-firmware-en.wav 固件下载失败提示音英文版
* /usr/share/paigo/audios/app-failed-download-firmware-cn.wav 固件下载失败提示音中文版
* /usr/share/paigo/images/app-failed-download-firmware-en.png 固件下载失败提示图片英文版
* /usr/share/paigo/images/app-failed-download-firmware-cn.png 固件下载失败提示图片中文版

*
* /usr/share/paigo/audios/app-upgrade-failed-cn.wav 升级失败中文提示音
* /usr/share/paigo/audios/app-upgrade-failed-en.wav 升级失败英文提示音
* /usr/share/paigo/images/app-upgrade-failed-cn.png 升级失败中文提示图片
* /usr/share/paigo/images/app-upgrade-failed-en.png 升级失败英文提示图片


* /var/lib/paigo/resources/%1/sounds/app-reboot.wav 系统重启提示音
*

=== 充电相关 ===

* /var/lib/paigo/resources/%1/sounds/app-charging.wav PAIGO系统充电器插入时的声音
* /var/lib/paigo/resources/%1/sounds/app-charger-unpluged.wav  PAIGO系统充电器拔除时的声音
* /var/lib/paigo/resources/%1/sounds/app-low-battery-voltage-warning.wav PAIGO系统低电量提示音
* /var/lib/paigo/resources/%1/animations/app-low-battery-voltage-warning/ PAIGO系统低电量提示动画
* /var/lib/paigo/resources/%1/sounds/app-charge-finished.wav 充电完成提示音
* /var/lib/paigo/resources/%1/animations/app-charge-finished/  PAIGO系统充电完成时的动画

=== 网络相关 ===

* /var/lib/paigo/resources/%1/sounds/app-boot-ap.wav PAIGO系统启动完成时的声音，AP模式

* /var/lib/paigo/resources/%1/sounds/app-connected.wav APP连接成功的提示音
* /var/lib/paigo/resources/%1/animations/app-connected/ APP连接成功的动画

* /var/lib/paigo/resources/%1/sounds/app-disconnected.wav APP断开连接时的提示音
* /var/lib/paigo/resources/%1/animations/app-disconnected/ APP断开连接时的动画


* /var/lib/paigo/resources/%1/sounds/app-wifi-connected.wav 在STA模式下，PAIGO成功连接到WIFI   
* /var/lib/paigo/resources/%1/sounds/app-wifi-disconnected.wav　WiFi连接断开的提示音  
* /var/lib/paigo/resources/%1/animations/app-wifi-disconnected/ WiFi连接断开的动画
* /var/lib/paigo/resources/%1/animations/app-standby-1 待机模式动画1
* /var/lib/paigo/resources/%1/animations/app-standby-2 待机模式动画2
* /var/lib/paigo/resources/%1/animations/app-standby-3 待机模式动画3
* /var/lib/paigo/resources/%1/animations/app-standby-4 待机模式动画4
* /var/lib/paigo/resources/%1/animations/app-standby-5 待机模式动画5

** app-failed-connected-to-wifi 在STA模式下，PAIGO未能连接到WIFI

** app-begin-upgrade-stm32.wav 开始更新STM固件   
** app-upgrade-cmd-failed.wav 升级命令执行失败
** app-downloading-firmware.wav 正在下载固件
** app-failed-download-firmware.wav 固件下载失败
** app-firmware-downloaded.wav 固件下载完成
** app-firmware-is-latest.wav 固件已经是最新版本
** system-upgraded-poweroff.wav 升级完成，请关闭电源
** system-upgraded.wav 升级完成
** system-upgrading.wav 正在升级，请勿关机

== 动画文件描述 ==

* /usr/share/images/putao-logo1.png 默认LOGO
* /var/lib/paigo/images/putao-logo1-cn.png 中文LOGO
* /var/lib/paigo/images/putao-logo1-en.png 英文LOGO

** app-boot PAIGO系统启动完成时的动画
** app-get-up PAIGO系统从睡眠模式返回工作模式时（唤醒）的动画
** app-gotosleep  PAIGO系统进入睡眠模式的动画

** app-charging PAIGO系统充电器插入时的动画
** app-connected APP连接成功动画
** app-disconnected APP断开连接动画




Paigo OS是只读系统(Read Only)，只有/var/目录是可读写的，用户通过APP发送的各种数据（图片/声音/动画）都会存放'''/var/lib/paigo'''目录下面。在 [[Paigo应用层通信协议]]里关于发送文件数据（图片/声音/动画）到Paigo OS中，协议中的文件编号必须大于4000。当Paigo接收到APP发送的显示图片 / 播放声音 / 播放动画，如果文件编号是4000及以下，Paigo会从/usr/share/paigo目录下调用相应的数据文件。如果文件编号4000以后的，Paigo会从/var/lib/paigo目录下调用相应的数据文件。文件编号的最大值是65535。

如果用户发送文件到Paigo时，协议数据中的文件编号在Paigo中对应的文件已经存在，那么用户发送的同编号的文件会覆盖原文件。

构建系统每次构建PAIGO固件时，会下载预置资源：

[http://paigo.g77k.com/system/paigo_builtin_resources.zip 预置资源包] 会解压到/usr/share/paigo/目录，
[http://paigo.g77k.com/system/builtin_sounds.zip 预置声音资源包] 会解压到/usr/share/sounds/目录

预置资源包子下载地址：http://paigo.g77k.com/system/paigo_builtin_resources.zip

预置声音资源包:http://paigo.g77k.com/system/builtin_sounds.zip

== 手动更新PAIGO ==

1. ssh远程登录到PAIGO机器

2. 进入/var/dl/目录，并下载固件包：cd /var/cd/ && wget http://paigo.g77k.com/system/paigo-update-xxxxxx.tar, xxxxxx是固件版本时间缀，如10191001

3. 验证固件包的完整性: md5sum paigo-update-xxxxxx.tar

4. 解压固件包，执行更新脚本：tar -xvf paigo-update-xxxxxx.tar && ./update.sh

5. 自动重启，进入升级模式，几分钟后，升级完成，自动重启，进入升级后的系统。完。